Architecture decisions:the next step

Software-architectuur is het resultaat van een set architectuurbeslissingen. Helaas ontbreekt het op dit moment aan een algemeen geaccepteerde aanpak voor het modelleren van deze beslissingen. Bestaande methodes houden bij de beschrijving van een beslissing niet met alle stakeholder-belangen rekening; ze ondersteunen het architectuurproces niet op optimale wijze en ze sluiten niet goed aan bij de rest van de architectuurdocumentatie, die doorgaans in meerdere architectural views wordt beschreven. Deze dissertatie rapporteert over meerdere empirische studies die gehouden zijn om het besluitvormingsproces in de praktijk beter te begrijpen. De kern is een framework voor architectuurbeslissingen, conform de conventies van de internationale architectuurbeschrijvingsstandaard ISO/IEC/IEEE 42010. Het framework bestaat uit vijf gerelateerde viewpoints, ieder gewijd aan verschillende stakeholder-belangen bij architectuurbeslissingen. De viewpoints kunnen individueel, of in combinatie, gebruikt worden om genomen architectuurbeslissingen in een softwareproject te beschrijven. Om erachter te komen of decision viewpoints ontwerpers kunnen ondersteunen bij het nemen van rationele beslissingen, hebben wij een vergelijkend multiple-case study met vier groepen senior software engineering-studenten uitgevoerd. De resultaten bevestigen dat studenten die decision views ontwikkelen volgens de viewpoint-definitie, meer systematisch mogelijke architectuuroplossingen verkennen en evalueren dan studentgroepen die het framework niet gebruiken. Tot slot bericht deze dissertatie over een lichtgewicht beslissings-centrische architectuur-evaluatiemethode, die viewpoints van het beslissingsframework gebruikt. De methode brengt de motivatie achter de belangrijkste architectuurbeslissingen die genomen zijn in een software-project aan het licht en evalueert deze, daarbij alle relevante forces die van invloed zijn geweest in beschouwing nemende

A mapping study on documentation in Continuous Software Development

Context: With an increase in Agile, Lean, and DevOps software methodologies over the last years (collectively referred to as Continuous Software Development (CSD)), we have observed that documentation is often poor. Objective: This work aims at collecting studies on documentation challenges, documentation practices, and tools that can support documentation in CSD. Method: A systematic mapping study was conducted to identify and analyze research on documentation in CSD, covering publications between 2001 and 2019. Results: A total of 63 studies were selected. We found 40 studies related to documentation practices and challenges, and 23 studies related to tools used in CSD. The challenges include: informal documentation is hard to understand, documentation is considered as waste, productivity is measured by working software only, documentation is out-of-sync with the software and there is a short-term focus. The practices include: non-written and informal communication, the usage of development artifacts for documentation, and the use of architecture frameworks. We also made an inventory of numerous tools that can be used for documentation purposes in CSD. Overall, we recommend the usage of executable documentation, modern tools and technologies to retrieve information and transform it into documentation, and the practice of minimal documentation upfront combined with detailed design for knowledge transfer afterwards. Conclusion: It is of paramount importance to increase the quantity and quality of documentation in CSD. While this remains challenging, practitioners will benefit from applying the identified practices and tools in order to mitigate the stated challenges

Architecture decisions: the next step : understanding, modeling, supporting and reviewing architecture decisions

Software-architectuur is het resultaat van een set architectuurbeslissingen. Helaas ontbreekt het op dit moment aan een algemeen geaccepteerde aanpak voor het modelleren van deze beslissingen. Bestaande methodes houden bij de beschrijving van een beslissing niet met alle stakeholder-belangen rekening; ze ondersteunen het architectuurproces niet op optimale wijze en ze sluiten niet goed aan bij de rest van de architectuurdocumentatie, die doorgaans in meerdere architectural views wordt beschreven. Deze dissertatie rapporteert over meerdere empirische studies die gehouden zijn om het besluitvormingsproces in de praktijk beter te begrijpen. De kern is een framework voor architectuurbeslissingen, conform de conventies van de internationale architectuurbeschrijvingsstandaard ISO/IEC/IEEE 42010. Het framework bestaat uit vijf gerelateerde viewpoints, ieder gewijd aan verschillende stakeholder-belangen bij architectuurbeslissingen. De viewpoints kunnen individueel, of in combinatie, gebruikt worden om genomen architectuurbeslissingen in een softwareproject te beschrijven. Om erachter te komen of decision viewpoints ontwerpers kunnen ondersteunen bij het nemen van rationele beslissingen, hebben wij een vergelijkend multiple-case study met vier groepen senior software engineering-studenten uitgevoerd. De resultaten bevestigen dat studenten die decision views ontwikkelen volgens de viewpoint-definitie, meer systematisch mogelijke architectuuroplossingen verkennen en evalueren dan studentgroepen die het framework niet gebruiken. Tot slot bericht deze dissertatie over een lichtgewicht beslissings-centrische architectuur-evaluatiemethode, die viewpoints van het beslissingsframework gebruikt. De methode brengt de motivatie achter de belangrijkste architectuurbeslissingen die genomen zijn in een software-project aan het licht en evalueert deze, daarbij alle relevante forces die van invloed zijn geweest in beschouwing nemende. Software architecture is the result of a set of architecture decisions. Unfortunately, there is currently no commonly accepted approach to architecture decision modeling. Existing approaches do not satisfy all stakeholder concerns in decision description; they do not optimally support the architecting process, and they do not integrate well with the rest of the architecture documentation, which is usually arranged in multiple architectural views. This dissertation reports on multiple empirical studies conducted to understand better the decision making process in practice. The core contribution is a framework for architecture decisions, following the conventions of the international architecture description standard ISO/IEC/IEEE 42010. The framework consists of five interrelated viewpoints, each of which being dedicated to satisfying different stakeholder concerns in architecture decisions. The viewpoints of the framework can be used individually, or in combination, to describe the architecture decisions made in a software project. To find out if decision viewpoints can support designers in making rational decisions, we conducted a comparative multiple-case study with four groups of senior software engineering students. The results confirm that students who create decision views according to the viewpoint definition explore and evaluate candidate architectural solutions more systematically than student groups who do not use the decision framework. Finally, this dissertation reports on a lightweight decision-centric architecture evaluation method, which uses viewpoints from the decision framework. The method uncovers and evaluates the rationale behind the most important architecture decisions made in a software project, considering all relevant forces that must be addressed by the decisions.

University of Groningen Forces on Architecture Decisions -A Viewpoint Forces on Architecture Decisions -A Viewpoint

Abstract-In this paper, the notion of forces as influences upon architecture decisions is introduced. To facilitate the documentation of forces as a part of architecture descriptions, we specify a decision forces viewpoint, which extends our existing framework for architecture decisions, following the conventions of the international architecture description standard ISO/IEC/IEEE 42010. The applicability of the viewpoint was validated in three case studies, in which senior software engineering students used it to document decisions in software projects; two of which conducted for industrial customers. The results show that the forces viewpoint is a well-received documentation approach, satisfying stakeholder concerns related to traceability between decision forces and architecture decisions